Skip to content

Add Azure recipe for the Radius.Data/mySqlDatabases resource type#56

Open
andrewmatveychuk wants to merge 42 commits intoradius-project:mainfrom
andrewmatveychuk:feature/mysql-azure-recipe
Open

Add Azure recipe for the Radius.Data/mySqlDatabases resource type#56
andrewmatveychuk wants to merge 42 commits intoradius-project:mainfrom
andrewmatveychuk:feature/mysql-azure-recipe

Conversation

@andrewmatveychuk
Copy link
Contributor

@andrewmatveychuk andrewmatveychuk commented Oct 2, 2025

Description

  • Added the Azure recipe to provision the resource as an Azure Database for MySQL
  • Added the new type property (tags), as suggested here, and defined the new type version for backward compatibility

Related PR: #46

Testing

From the repository root folder:

  1. Create the type: rad resource-type create -f '.\Data\mySqlDatabases\mySqlDatabases.yaml'
  2. Compile the Bicep extension: rad bicep publish-extension -f '.\Data\mySqlDatabases\mySqlDatabases.yaml' --target '.\Data\mySqlDatabases\radiusResources.tgz'
  3. Add the compiled radiusResources.tgz file to your bicepconfig.json file to enable IntelliSense support in VSCode.
  4. Publish the recipe to a container registry. For example: rad bicep publish --file '.\Data\mySqlDatabases\recipes\azure-database-for-mysql\bicep\azure-database-for-mysql.bicep' --target 'br:ghcr.io/andrewmatveychuk/azure-database-for-mysql:0.54'
  5. Register the recipe in your Radius environment. For example: rad recipe register default --environment default --resource-type 'Radius.Data/mySqlDatabases' --template-kind bicep --template-path 'ghcr.io/andrewmatveychuk/kubernetes-mysql:0.54'
  6. Configure the Azure provider for the environment as described here:
    • The resource group used by the Azure provider should exist.
    • The configured identity should be granted the Contributor role for the target resource group.
  7. Define a sample application using the type, deploy it, and check for resource provisioning in the target resource group. For example:
extension radius
extension radiusResources

@description('The Radius Application ID. Injected automatically by the rad CLI.')
param application string

@description('The env ID of your Radius Environment. Set automatically by the rad CLI.')
param environment string

resource mysql84 'Radius.Data/mySqlDatabases@2025-08-01-preview' = {
  name: 'mysql84'
  properties: {
    environment: environment
    application: application
    database: 'wp_db84'
    username: 'wp_user84'
    version: '8.4'
  }
}

var tags = {
  environment: 'production'
  owner: 'team-b'
}

resource mysql80 'Radius.Data/mySqlDatabases@2025-10-01-preview' = {
  name: 'mysql80'
  properties: {
    environment: environment
    application: application
    database: 'wp_db80'
    username: 'wp_user80'
    version: '8.0'
    tags: tags
  }
}

resource mysql57 'Radius.Data/mySqlDatabases@2025-10-01-preview' = {
  name: 'mysql57'
  properties: {
    environment: environment
    application: application
    database: 'wp_db57'
    username: 'wp_user57'
    version: '5.7'
    tags: {
      'custom-environment': 'test'
      'custom-owner': 'team-a'
    }
  }
}

andrewmatveychuk and others added 30 commits September 18, 2025 16:25
@andrewmatveychuk
Added recipe for MySQL database
b7a5ed9 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Removed platform-specific properties for better abstraction
ab860ba 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Removed resource-specific properties from the documentation
05e5dcb 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Added sample Radius application using the mySqlDatabases type
6f8127f 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Moved the sample to proper location
4ae7a70 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@zachcasper @andrewmatveychuk
Routes Resource Type definition (radius-project#42)
e82725d 
Implementation of
radius-project/design-notes#110

---------

Signed-off-by: Zach Casper <zachcasper@microsoft.com>
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@sk593 @andrewmatveychuk
Add documentation for workflow testing (radius-project#44)
3a6e7ce 
This PR adds documentation for automated workflow testing. Testing is
only required for stable resource types. The following changes have been
made:

- Move the build folder into .github
- Add documentation for adding tests for stable resource types
- Add documentation for make targets
- Removed bicepconfig.json and generate it during automated workflow
runs

---------

Signed-off-by: sk593 <shruthikumar@microsoft.com>
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Removed the sample Radius application for the mySqlDatabases type
02a732e 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Updated the API version to the resource contribution month
6fb6817 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Renamed the user parameter to username
f37275c 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Synced parameter descriptions
acd666e 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Removed the root_password property and moved from the container tag t…
aae2da3 
…o major MySQL version property

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Updated type description with sample application
ab8251d 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Updated the recipe file name to lowercase
d9a038c 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Updated the file name to lowercase
725f339 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Updated the port property description
d4278c4 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Converted the password property to a variable instead of optional par…
f000827 
…ameter tp honor the type specification

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk @Reshrahim
Update Data/mySqlDatabases/README.md
fe4342c 
Co-authored-by: Reshma Abdul Rahim <61033581+Reshrahim@users.noreply.github.com>
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk @Reshrahim
Update Data/mySqlDatabases/README.md
a3dd353 
Co-authored-by: Reshma Abdul Rahim <61033581+Reshrahim@users.noreply.github.com>
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk @Reshrahim
Update Data/mySqlDatabases/README.md
1cf69ee 
Co-authored-by: Reshma Abdul Rahim <61033581+Reshrahim@users.noreply.github.com>
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Updated the recipe with explicit evaluation for optional Bicep parame…
ced60b8 
…ters to account for the inputs from the recipe context object

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Removed WordPress-specific information from the type description for …
ce9a7c8 
…template generalization

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Revert "Routes Resource Type definition (radius-project#42)"
2fb0ce9 
This reverts commit e82725d.

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Revert "Add documentation for workflow testing (radius-project#44)"
a757464 
This reverts commit 3a6e7ce.

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Updated parameter validation to use Bicep safe access operator
b3dae08 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Updated type description
86a05cb 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Merge branch 'radius-project:main' into main
1bde24b
@andrewmatveychuk
Merge branch 'radius-project:main' into main
5aa47cf
@andrewmatveychuk
Merge remote-tracking branch 'upstream'
fb020ed
@andrewmatveychuk
Added MySQL recipe for Azure Database for MySQL Flexible Server
098a6b9 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Added the new optional tags property to the MySQL recipe for Kubernetes
9a4e8b3 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Fixed the tag property definition in the 'Radius.Data/mySqlDatabases'…
942cd93 
… type

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Fixed tag handling in recipes
9428816 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk andrewmatveychuk requested review from a team as code owners October 2, 2025 15:06
@andrewmatveychuk
Copy link
Contributor Author

andrewmatveychuk commented Oct 2, 2025

@Reshrahim @zachcasper Could you please review and let me know your thoughts?

@andrewmatveychuk
Copy link
Contributor Author

andrewmatveychuk commented Oct 2, 2025

The PR to update the documentation for the Azure provider with missing details: radius-project/docs#1539

Reshrahim
Reshrahim requested changes Oct 3, 2025
View reviewed changes
Copy link
Contributor

@Reshrahim Reshrahim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the contribution.

I made some suggestions as I manually tested the Azure Recipe. I was able to deploy but the env variables did not get populated on the container via connections.

@andrewmatveychuk
Removed special character from MySQL default username and added valid…
30cc774 
…ation for maximum length

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Merged the new type version into existing one and added info about pr…
7611c33 
…operty default values

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Converted the auto-generated password variable to a parameter to over…
5528e86 
…come the current limitation of working with secrets in Radius

Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Copy link
Contributor Author

andrewmatveychuk commented Oct 8, 2025

Thanks for the contribution.

I made some suggestions as I manually tested the Azure Recipe. I was able to deploy but the env variables did not get populated on the container via connections.

FYI, I'm still looking into this, and I'm trying to accomodate the TLS enforcement into the recipe.

@andrewmatveychuk
Removed double-referencing in the output object
615ec04 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Converted database to nested resource
80e745e 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Updated resource API version
479a4c0 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Added second factor to make resource name more unique
87fe77a 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Corrected formatting
93f2ec9 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Converted type description to Markdown
4c7c283 
Signed-off-by: Andrew Matveychuk <andrew@andrewmatveychuk.com>
@andrewmatveychuk
Copy link
Contributor Author

andrewmatveychuk commented Oct 13, 2025

Thanks for the contribution.

I made some suggestions as I manually tested the Azure Recipe. I was able to deploy but the env variables did not get populated on the container via connections.

@Reshrahim
I think that should work correctly now. It turned out that the databasePort property can only be used as an input parameter and cannot be referenced later, which resulted in an error when deploying the recipe Bicep template directly, rather than via Radius.

@andrewmatveychuk andrewmatveychuk mentioned this pull request Oct 13, 2025
Open
@Reshrahim
Copy link
Contributor

Reshrahim commented Feb 6, 2026

@andrewmatveychuk - Can you review https://github.com/radius-project/resource-types-contrib/pull/95/changes#diff-efca8759f11a6cd43d11b7c4f5948402d7d743097b2f08ed6a970d897bfbb618 as a pattern for modeling secrets and start updating the mysql type. This will be published as the guidance on modeling secrets with types once the core types (extensible) are added to the Radius install

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@Reshrahim Reshrahim Awaiting requested review from Reshrahim

Requested changes must be addressed to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@andrewmatveychuk @Reshrahim @zachcasper @sk593